home *** CD-ROM | disk | FTP | other *** search
/ PC Media 4 / PC MEDIA CD04.iso / share / os2 / 10unzs / unzsh.doc < prev    next >
Text File  |  1994-01-21  |  18KB  |  423 lines
  1.  
  2.                                             -- The UnZip Shell - UNZSH.EXE --
  3.  
  4.                                          OS/2 PM front-end for Info-ZIP UnZip
  5.  
  6.                                                             Shareware Version
  7.  
  8.                                                                  Version 1.0s
  9.  
  10.                                                                       1/15/94
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.                            -- Legal Issues --
  29.        ---------------------------------------------------------
  30.  
  31. The UnZip Shell is Copyright (C), John Wagner 1994. All Rights Reserved.
  32.  
  33. There are two executable programs in the archive - The UnZip Shell
  34. (UNZSH.EXE) and Info-ZIP UNZIP (UNZIP.EXE). One program is SHAREWARE,
  35. and the other is FREE. The following paragraphs explain the difference.
  36.  
  37.        ---------------------------------------------------------
  38.  
  39.                       The UnZip Shell is Shareware
  40.        ---------------------------------------------------------
  41. If you have the shareware version:
  42. You may evaluate the program for TWO WEEKS. If you wish to continue
  43. using the program after TWO WEEKS, you must obtain a registered copy. If
  44. you don't wish to continue using the program after two weeks, please
  45. delete your copy of it. All users are allowed and encouraged to pass on
  46. copies of the SHAREWARE version of the program.
  47.  
  48. There are two versions of The UnZip Shell, one is the SHAREWARE version
  49. and the other is the REGISTERED VERSION. The two programs are identical
  50. in function, but there are some additional features in the REGISTERED
  51. version.
  52.  
  53.        ---------------------------------------------------------
  54.  
  55.                    The UnZip Shell SHAREWARE VERSION:
  56.        ---------------------------------------------------------
  57.         Default settings are not editable. You can modify the
  58.         settings while the program is running, but the settings
  59.         aren't saved.
  60.  
  61.         Cannot use Object Association when inspecting items
  62.         in ZIP files.
  63.  
  64.         Uses the OS/2 E.EXE editor as a file viewer.
  65.  
  66.         "SETUP" option works, but the changes you make aren't
  67.         saved.
  68.  
  69.         Reminder window pops-up when you view a file, when you
  70.         enter the "SETUP" window, and when you quit the program.
  71.  
  72.         The SHAREWARE version allows for a full evaluation of
  73.         the program to see if it suits your needs.
  74.  
  75.        ---------------------------------------------------------
  76.  
  77.                    The UnZip Shell REGISTERED VERSION:
  78.        ---------------------------------------------------------
  79.         Defaults can be modified and saved.
  80.  
  81.         Allows the use of any editor to view files.
  82.  
  83.         Optionally uses the OS/2 Association feature when a
  84.         file is selected for viewing by calling the appropriate
  85.         (default) associated object. This means if you select a
  86.         file with a .ICO extension, the OS/2 Icon Editor will
  87.         be called up with the icon loaded into it.
  88.  
  89.         "SETUP" option saves the settings.
  90.  
  91.         No reminder window - A clear conscience!
  92.  
  93.        ---------------------------------------------------------
  94.  
  95.               If you have purchased a registered version:
  96.        ---------------------------------------------------------
  97. Thank you! Please make sure that you do not give anyone your registered
  98. software, as doing so would seriously hurt my business (and be really
  99. uncool!). Please do not upload it to BBS's, do not give a copy to a
  100. friend, or offer it for distribution in any way shape or form. You will
  101. find a copy of the SHAREWARE version of the program on your distribution
  102. disk, so if someone wants a copy, please give them the SHAREWARE version
  103. only. Thank you again for supporting my efforts to bring you quality
  104. software at an honest price.
  105.  
  106.        ---------------------------------------------------------
  107.  
  108.                   Info-ZIP UNZIP (UNZIP.EXE) is FREE:
  109.        ---------------------------------------------------------
  110. The included file UNZIP.EXE is FREE SOFTWARE - it is merely being
  111. included with this package as a convenience to the user. It should be
  112. noted that you may use UNZIP.EXE from the command line for FREE, without
  113. retribution to anyone. You may distribute UNZIP.EXE for FREE. This is in
  114. accordance with the authors of UNZIP.EXE wishes.
  115.  
  116. The source code for UNZIP is freely available at various FTP sites and
  117. BBS's. You will find a ZIP file enclosed in this package entitled
  118. UNZIPDOX.ZIP. This file contains the full documentation for UNZIP.EXE.
  119.  
  120. When you register The UnZip Shell, I will include the latest version I
  121. have of Info-ZIP UNZIP and it's source code as a convenience FOR FREE.
  122. If you desire to have just the UNZIP program and it's source code, I
  123. will mail it to you for a copying and handling fee of $10. I'm sorry
  124. I have to ask for anything if all you want is the UNZIP program and it's
  125. source code, but it costs me a considerable amount of money to run a
  126. small business. If all you want is the UNZIP program and it's source, I
  127. would rather you got it free from a BBS or FTP it from somewhere on the
  128. Internet.
  129.  
  130. To further clarify the status of Info-ZIP UNZIP, the following text is
  131. extracted from the file COPYING included in the Info-ZIP UNZIP package:
  132.  
  133.    "an UnZip executable may be distributed with a commercial product SO
  134.    LONG AS IT IS CLEAR THAT UNZIP IS NOT BEING SOLD, THAT THE SOURCE
  135.    CODE IS FREELY AVAILABLE, AND THAT THERE ARE NO EXTRA OR HIDDEN
  136.    CHARGES RESULTING FROM ITS USE BY OR INCLUSION WITH THE COMMERCIAL
  137.    PRODUCT."
  138.  
  139.        ---------------------------------------------------------
  140.  
  141.                     How to Register The UnZip Shell:
  142.        ---------------------------------------------------------
  143. Registration for The UnZip Shell is a mere $12 U.S. That price includes
  144. shipping (in North America) and floppy disk media. Outside of North
  145. America, please add $2 for shipping and handling. Please send checks
  146. drawn from a U.S. bank, or money orders that are drawn in U.S. funds,
  147. made out to John Wagner. All others will be returned. Do not send credit
  148. card information as I am unable to process credit cards.
  149.  
  150. When you register, you will receive the latest version of The Unzip
  151. Shell on a 3.5 inch disk. Please see the matrix above for the
  152. differences between the SHAREWARE and REGISTERED versions of the
  153. program.
  154.  
  155. The address for registering The UnZip Shell is:
  156.  
  157.                     John Wagner
  158.                     RR 1  Box 107
  159.                     Derby Line, VT 05830
  160.  
  161. For your convenience, a file called INVOICE.DOC is included that
  162. contains all of the information I'll need to get your order processed.
  163. To expedite your order, please print INVOICE.DOC, fill out the requested
  164. information and send it in with your order.
  165.  
  166.        ---------------------------------------------------------
  167.  
  168.                             Upgrade policy:
  169.        ---------------------------------------------------------
  170. Since the low, low price of $12 pretty much rules out mass mailings to
  171. registered users, I will be unable to notify registered users of
  172. upgrades. I will release upgrades to the shareware version of the
  173. program which will reflect the latest features of the registered
  174. program. If you are a registered user, and come across a newer version
  175. of the program, and you would like upgrade to a registered copy of it,
  176. send $5 and I'll send you a disk as mentioned above.
  177.  
  178. Indicate on your order that you are a registered user and the current
  179. registered version # that you have. If you are using the latest version,
  180. I'll deposit your check, but hold your order until an upgrade is
  181. available, at which time your order will be sent promptly.
  182.  
  183. Distributing The UnZip Shell:
  184. The SHAREWARE version of The UnZip Shell may be distributed as long as
  185. the ENTIRE package is distributed together, and no additional files are
  186. added to the archive. The following list is the SHAREWARE UnZip Shell
  187. archive:
  188.  
  189.         UNZSH.EXE
  190.         UNZSH.DOC
  191.         INVOICE.DOC
  192.         FILE_ID.DIZ
  193.         UNZIP.EXE
  194.         UNZIPDOX.ZIP
  195.         VENDOR.DOC
  196.  
  197. Please make certain that all of the files are included when distributing
  198. the archive. If you have the REGISTERED version of the program, PLEASE
  199. DO NOT distribute it. If you have the REGISTERED version of the program,
  200. I have included a copy of the latest SHAREWARE version on the diskette I
  201. sent you under the filename xxUNZS.ZIP (where xx is the version and
  202. sub-version).
  203.  
  204.        ---------------------------------------------------------
  205.  
  206.                        Disclaimer - PLEASE READ:
  207.        ---------------------------------------------------------
  208. The UnZip Shell is provided "as is", with NO GUARANTEE that it works as
  209. described here, or anywhere else. USE IT AT YOUR OWN RISK.
  210.  
  211.        ---------------------------------------------------------
  212.  
  213.                        What The UnZip Shell does:
  214.        ---------------------------------------------------------
  215. The UnZip Shell is an OS/2 PM front end for Info-ZIP UNZIP file
  216. extraction utility. The following instructions will guide you
  217. step-by-step to installing UnZip Shell and integrating it into the
  218. Workplace Shell. The UnZip Shell allows you to activate files in your
  219. ZIP archives without unzipping the whole archive. This is handy for
  220. viewing text files, etc... Using the OS/2 Object Association feature,
  221. you can activate any object that is associated with the files contained
  222. within your archive files.
  223.  
  224.        ---------------------------------------------------------
  225.  
  226.                      Quick and Dirty installation:
  227.        ---------------------------------------------------------
  228. If you are an OS/2 and WPS expert, you can can get up and running
  229. quickly by following these brief instructions:
  230.  
  231.       Put a copy of Info-ZIP UNZIP.EXE in your path
  232.  
  233.       Create a program reference object for UNZSH.EXE
  234.  
  235.       Set the association for the object you just created to *.ZIP
  236.  
  237.       Make sure you have a TEMP or TMP variable set in you CONFIG.SYS
  238.       file
  239.  
  240.       Optionally, you can add a default target path as a parameter in
  241.       the settings notebook like so: -d=path
  242.  
  243.        ---------------------------------------------------------
  244.  
  245.                       How to install The UnZip Shell:
  246.        ---------------------------------------------------------
  247. Copy UNZIP.EXE to a directory that is in your OS/2 path. If UNZIP.EXE
  248. isn't in your path, The UnZip Shell won't be able to find it and won't
  249. run properly.
  250.  
  251. Make sure you have a TEMP or TMP variable set in your CONFIG.SYS file:
  252.  
  253.     -CONFIG.SYS-
  254.     SET TEMP=C:\TEMP
  255.  
  256. Make sure C:\TEMP exists! The UnZip Shell uses the directory specified
  257. in the TMP or TEMP environment variable as a work directory. The UnZip
  258. Shell will run if you don't have a TMP or TEMP environment variable, but
  259. it will use the root directory of the drive that OS/2 started from.
  260.  
  261. I would like to point out that running The UnZip Shell without a TMP or
  262. TEMP variable set is a potentially dangerous situation in the rare case
  263. that you have a ZIP file with a file in it called CONFIG.SYS, and you
  264. attempt to read it, and ignore the warning that reading the file will
  265. overwrite a file that exists... make sure you have a TMP or TEMP
  266. environment variable set, it's the right thing to do!
  267.  
  268. Copy UNZSH.EXE to a sub-directory on your hard drive. Create a program
  269. reference object that references UNZSH.EXE.
  270.  
  271. Example:
  272.  
  273.         Copy UNZSH.EXE to the C:\OS2\APPS directory
  274.  
  275.         Open the TEMPLATES folder, and drag out a PROGRAM template onto
  276.         your desktop (you can place it in a folder later).
  277.  
  278.         When the SETTINGS notebook opens, enter: C:\OS2\APPS\UNZSH.EXE
  279.  
  280.         Optionally, in the PARAMETERS edit window, enter the path that
  281.         you most often unzip files to, preceded by '-d='. Example:
  282.         -d=C:\TEMP
  283.  
  284. Don't close the settings notebook yet...
  285.  
  286. Setup an Association:
  287. Select the "Association" tab from the Settings notebook. In the edit
  288. window labeled "New Name", type in: *.ZIP and then click on the "Add>>"
  289. button. Close the Settings notebook.
  290.  
  291. This associates The UnZip Shell with any file that has a .ZIP extension.
  292. Now, whenever you come across a ZIP file in the WPS, you can just
  293. double-click on it, and it will run UNZSH.EXE.
  294.  
  295.        ---------------------------------------------------------
  296.  
  297.         You can also run The UnZip Shell from the command line:
  298.        ---------------------------------------------------------
  299.    USAGE: UNZSH [-D=path to unzip to] [filename.zip]
  300.  
  301.    WHERE: [path to unzip to] is optional, do not include the []'s - it
  302.           specifies the target drive/directory to place the unzipped
  303.           files. Do include the -D= though.
  304.  
  305.    WHERE: [filename.zip] specifies the file to unzip.
  306.  
  307. If you don't specify a file to unzip (by running the program without the
  308. command line parameters) you can still load a ZIP file from within the
  309. program by clicking the "OPEN" button.
  310.  
  311.        ---------------------------------------------------------
  312.  
  313.                         Running The UnZip Shell:
  314.        ---------------------------------------------------------
  315. Regardless of how you start The UnZip Shell, you will have the following
  316. options...
  317.  
  318. Actions before unzipping:
  319.  
  320.     Viewing text files in the ZIP archive:
  321.       You can double click on a filename in the file listbox and The
  322.       UnZip Shell will bring up the OS/2 'E' editor with the selected
  323.       file loaded. When UnZip Shell exits, it shuts down any 'E'
  324.       sessions that may have been started and erases any files that
  325.       where being viewed. All of this takes place in the directory
  326.       specified in your TEMP or TMP environment variable.
  327.  
  328.    Existing file Options:
  329.       These options control what UNZIP.EXE does when it tries to extract
  330.       a file from a ZIP file, and the file already exists in the
  331.       directory that it is extracting to.
  332.  
  333.    Embedded directory Options:
  334.       ZIP files can have sub-directories embedded in them. It is usually
  335.       desirable to re-create these sub-directories when unzipping the
  336.       file. By default, UNZIP.EXE will create the sub-directories. If
  337.       you select "Junk directories" (the equivalent of running UNZIP.EXE
  338.       with the -j parameter) then the sub-directories won't be created,
  339.       and all of the files will be extracted into the Target Directory.
  340.  
  341.    Specify the drive/dir you want to unzip the files to (Target Directory):
  342.       If you specify a directory that doesn't exist, The UnZip Shell
  343.       will make sure you want to create it. NOTE: UnZip Shell will only
  344.       create a directory one level deep, and it can't create drives that
  345.       don't exist<g>.
  346.  
  347.    Opening another ZIP file:
  348.       If you click the "OPEN..." button, you can select another file to
  349.       unzip.
  350.  
  351.    Setup the program configuration: (REGISTERED VERSION ONLY)
  352.       If you click the "SETUP" button, you will be presented with a
  353.       dialog window that contains the program startup defaults. From
  354.       this window, select the settings you want the program to start up
  355.       with every time.
  356.  
  357.       You can also select a different editor or file viewer to use when
  358.       you select a file to view. If the program you choose to view files
  359.       is not in your path, be sure to include the fully qualified path
  360.       name to the program (ie: C:\DOS\EDIT.COM) (like an OS/2 user is
  361.       going to use DOS EDIT!). Also, be sure to include the extension of
  362.       the program (ie: EPM.EXE) (that's more like it!).
  363.  
  364.       The registered version of The UnZip Shell allows you to use the
  365.       object association feature of the WPS. To do so, select this
  366.       option while in the setup dialog.
  367.  
  368. Actions after unzipping:
  369.    Create a WPS Shadow of the dir the files are being placed in:
  370.       This is the default setting. Click the checkbox off if you don't
  371.       want this to happen. As the object that is created is a shadow, it
  372.       can be safely deleted without affecting the actual directory. If
  373.       you delete the file objects however, the files will be deleted.
  374.  
  375.    Create an OS/2 session:
  376.       Select this option if you want The UnZip Shell to start an OS/2
  377.       command line window for you after unzipping the files. The session
  378.       will be started and the active drive/dir will be the one that the
  379.       unzipped files were placed in.
  380.  
  381. How to exit:
  382.  
  383.    Select "OK":
  384.       If you select "OK", The UnZip Shell will start a session that runs
  385.       UNZIP.EXE to unzip the files. That session is a Windowed OS/2
  386.       session and it runs independently of The UnZip Shell (go OS/2!).
  387.       What this means is you will see the session that is unzipping the
  388.       files running even after The UnZip Shell has stopped running. The
  389.       UNZIP.EXE session will close itself when it is done unzipping the
  390.       files (that is unless you specified the "Create and OS/2 session"
  391.       option, in which case the OS/2 Window will just stay open in the
  392.       directory that all the files were placed in).
  393.  
  394.    Select "CANCEL":
  395.       If you select "CANCEL", The UnZip Shell will confirm that you want
  396.       to cancel.
  397.  
  398.    Exit with the "System Menu":
  399.       If you select "Close" from the System Menu (upper left corner),
  400.       then The UnZip Shell will close immediately without confirming you
  401.       want to quit and without unzipping any files. The SHAREWARE
  402.       version will still display it's reminder window.
  403.  
  404. IMPORTANT!!!:
  405.      Regardless of how you exit the program, The UnZip shell will
  406.      shutdown any viewers or programs that you started while using
  407.      viewing a files contents, and delete the temporary files that it
  408.      created.
  409.  
  410.        ---------------------------------------------------------
  411.  
  412.                          Contacting the author:
  413.        ---------------------------------------------------------
  414. John Wagner is available on on CompuServe, account # 72122,2412. He can
  415. also be reached by phone at (802)895-4512 - after 5pm and before 10pm
  416. EST. The author suggests (and requests) that you attempt to contact him
  417. electronically (CIS, or phone) for a speedy response.
  418.  
  419. History:
  420.  
  421. - 1/25/94 Initial Release
  422.     v1.0 - (v1.0s Shareware and v1.0r Registered)
  423.